Inside Macintosh: Mac OS 8 Toolbox Reference /

Chapter 7 - Finder Interface Reference / Finder Interface Functions

Manipulating Folder Descriptors /

IdentifyFolder

NEW WITH MAC OS 8

Gets the folder type for the specified folder.

pascal OSErr IdentifyFolder (
                     short vRefNum,
                     long dirID,
                     FolderType *foldType);

vRefNum

The volume reference number (or the constant kOnSystemDisk for the startup disk) of the volume containing the folder for which you wish the type to be identified.

dirID

The directory ID number for the folder for which you wish the type to be identified.

foldType

On output, a pointer to the folder type of the folder with the specified vRefNum and dirID parameters.

function result

A result code; see "Result Codes".

DISCUSSION

The folder type is identified for the folder specified by the vRefNum and dirID parameters, if such a folder exists. IdentifyFolder may take several seconds to complete. Note that there may be multiple folder descriptors that map to an individual folder; IdentifyFolder returns the folder type of one of those descriptors.

SPECIAL CONSIDERATIONS

Before calling the IdentifyFolder function, you must pass the selector gestaltFindFolderAttr to the Gestalt function. If the gestaltFolderDescSupport bit is set, IdentifyFolder is available.